home *** CD-ROM | disk | FTP | other *** search
/ The CICA Windows Explosion! / The CICA Windows Explosion! - Disc 1.iso / util / wncode26.zip / README.TXT < prev    next >
Text File  |  1994-10-31  |  12KB  |  266 lines
  1.      Wincode: Multi-Purpose Encoder/Decoder for Windows
  2.              (C) Snappy_Inc. (1993,1994)
  3. ------------------------------------------------------------
  4.              written by George H. Silva
  5.  
  6.  
  7.      ***PLEASE DISTRIBUTE FREELY WITH ALL FILES INTACT***
  8.  
  9. Files:    WINCODE.EXE    the main executable program
  10.           WCODEDLL.DLL   dynamic link library of coding functions
  11.           HOOKDLL.DLL    dynamic link library of menu hook functions
  12.           WINSORT.EXE    a companion file-sort utility
  13.           ZIPLINK.EXE    executable link to PKZIP/PKUNZIP
  14.           ZIPLINK.PIF    ZIPLINK.EXE program information file
  15.           SUM.EXE        a BONUS "sum -r/size" DOS utility
  16.           README.TXT     this file
  17.           HELPME.TXT     Wincode basics and information for obtaining
  18.                          the HELP file (WINCODE.HLP)
  19.           INSTALL.EXE    the Install/Upgrade program
  20.           INSTALL.HLP    the Installer HELP file
  21.           INSTALL.INF    the Installer information file
  22.           CHECKSUM.REF   checksum reference file
  23.  
  24.      ***SEE THE HELPME.TXT FILE FOR MORE INFORMATION***
  25.  
  26. This file contains the following information:
  27.  
  28. I.    About Wincode
  29. II.   Wincode Features (very brief list!)
  30. III.  Coming Soon
  31. IV.   Requirements
  32. V.    Installing/Running Wincode
  33. VI.   BONUS 'sum -r/size' Utility
  34. VII.  Availability
  35. VIII. Other Snappy_Inc. Software
  36. IX.   Mailing List
  37. X.    Known Limitations
  38. XI.   Note to AOL Users
  39. XII.  Copyrights
  40.  
  41.  
  42.  
  43. I. *** About Wincode ***
  44.  
  45. Wincode is a Windows 3.1 program which converts 8-bit BINARY (EXE, COM,GIF,
  46. etc) files to 7-bit ASCII (Text) files (and vice versa) through a process
  47. known as bit-shifting. Wincode currently supports UU/XX and Base64 (MIME
  48. 1.0 conformant) coding. This BINARY/ASCII conversion allows you to send and
  49. receive binary files via e-mail or any other ascii-based communications
  50. system. It provides a quick and easy way to distribute programs to people all
  51. over the world (it takes a few minutes, on average, for e-mail to reach across
  52. the world). UUcoding is a common practice on many Internet NewsGroups in which
  53. users wish to exchange binary data. Base64 coding is used by MIME
  54. (Multipurpose Internet Mail Extensions) conformant e-mail software as a method
  55. for attaching binary data to ascii e-mail. Both methods perform the same
  56. overall function (i.e. allow binary data to be safely transmitted through
  57. e-mail) but require different formatting algorithms. In the future, Wincode
  58. will also support BINHEX coding and *may* even handle the actual "e-mailing"
  59. of the data...
  60.  
  61. Wincode and the associated executables and DLLs (NOT including the HELP file)
  62. are distributed as FREEWARE. However, we want to make a distinction: the
  63. program is FREEWARE, but it is NOT Public Domain. Snappy_Inc still retain the
  64. Copyright to the source code and to the use and distribution of the program.
  65. The HELP file is available for a small fee ($5.00 US) but is NOT required for
  66. Wincode to function correctly. Ordering the HELP file also entitles you to
  67. future updates and e-mail based support. The $5.00 fee is mainly to offset
  68. development costs and the amount of personal time invested. See below and the
  69. file HELPME.TXT for more information on obtaining support.
  70.  
  71. Wincode is 100% compatible with all standard UUcoders and MIME 1.0 conformant
  72. software. The MIME (Base64) support was developed under the guidelines of RFC
  73. 1521 (September 1993) and is subject to our understanding of the document. We
  74. welcome all comments and error corrections. We have tried to incorporate as
  75. many extra features as possible to make the en/de-coding process painless. The
  76. average user may not need/use all of Wincode's features, but they *are* Free!
  77.  
  78. NOTE TO DEVELOPERS: WCODEDLL.DLL contains ALL of Wincode's 'working' code
  79. (currently) accessed through 66 functions/procedures. We created this SIMPLE
  80. interface to allow Developers to integrate the Wincode Engine into any
  81. program. We will provide the API and royalty free usage to interested
  82. developers under certain conditions. Please contact Snappy_Inc for more
  83. details.
  84.  
  85.  
  86.  
  87. II. *** Wincode Features (very brief list!) ***
  88.  
  89.        - Full featured Windows 3.1 program
  90.        - Easy access ToolBar for hassle-free operation
  91.        - Drag and Drop support (use for batch en/de-coding -> Wincode also
  92.          allows multi-file selection from File Open dialogs)
  93.        - SMART decoding (handles single files, multi-part files, can
  94.          determine what is encoded or not, etc. -> see the HELP file for
  95.          more information)
  96.        - Fully configurable...We're not joking!
  97.        - EMBL UUcode compatible
  98.        - Supports UU, XX or User defined En/De-coding
  99.        - Supports Base64 (MIME conformant) En/De-coding
  100.        - Supports En/De-coding to/from the Clipboard!
  101.        - Supports automatic ZIP/UNZIP (requires PKWare's ZIP/UNZIP 2.0)
  102.        - Application menu hooking option to integrate Wincode's menu
  103.        - Includes INSTALL program for upgrades
  104.        - Integrated file-sorting companion program (separate
  105.          executable for easier upgrading) which handles MANY types
  106.          of file header formats
  107.        - Multimedia support - see the HELP file for details
  108.        - It's ALL FREE...
  109.  
  110.  
  111.  
  112. III. *** Coming Soon ***
  113.  
  114.           - BINHEX en/de-coding support.
  115.           - The ability to handle actual "e-mailing" of encoded data files.
  116.           - User suggestions...?
  117.  
  118.  
  119.  
  120. IV. *** Requirements ***
  121.  
  122.          - IBM compatible running DOS 3.3 or higher
  123.          - 286 or higher processor with at least 2MB memory
  124.          - Windows 3.1/3.11 running in standard or enhanced mode
  125.          - About 500K of disk space without HELP file (~750K with HELP file)
  126.  
  127.  
  128.  
  129. V. *** Installing/Running Wincode ***
  130.  
  131. If you have not already done so, expand the ZIP archive into a temporary
  132. directory (or a floppy-disk). Start Windows, select FILE|RUN from Program
  133. Manager or File Manager and type in the full path of the INSTALL.EXE program
  134. (run it). The INSTALL program will copy/expand all the files to a directory
  135. you specify (overwriting older files), upgrade your WINCODE.INI (if you are
  136. running an older version of Wincode) and create a Program Manager Group and/or
  137. icon. See the HELPME.TXT file for basic instructions on using Wincode.
  138.  
  139. ***IMPORTANT NOTE: ALL files (listed above) must be present in the same
  140. directory for Installer to function properly. You should INSTALL first,
  141. then move selected files to directories of your choice (i.e. delete the
  142. README.TXT, place SUM.EXE in your DOS directory, etc.). The install program
  143. uses the Windows LZEXPAND.DLL to decompress and copy the required files. If
  144. you receive any error messages during install, please contact Snappy_Inc for
  145. assistance.
  146.  
  147.  
  148.  
  149. VI. *** BONUS 'sum -r/size' Utility ***
  150.  
  151. We have included a small DOS executable which will quickly calculate 
  152. UNIX 'sum -r/size' checksums. This program is useful for checking the
  153. integrity of files that have been transferred over communications lines
  154. that are questionable (or, to some extent, checking for virus infections).
  155. Wincode supports both line and/or file Checksum checking while decoding
  156. and will insert Checksums (line and/or file) while encoding. This utlity is 
  157. provided as a stand-alone DOS program. For program usage, type 'SUM' (with 
  158. no parameters) at the DOS prompt. The included file 'CHECKSUM.REF' contains
  159. the proper checksum values for all of the files in the Wincode package.
  160.  
  161.  
  162.  
  163. VII. *** Availability ***
  164.  
  165. Recent versions of Wincode (or other Snappy_Inc software) are always
  166. available at the following locations:
  167.  
  168.     - CompuServe (check the WinShare forum; keyword: Snappy, Wincode, etc.)
  169.  
  170.     - America Online (keyword: Snappy, Wincode, etc.)
  171.  
  172.     - The Nebuolic Cheese BBS  [SysOp: Stephen Lau]
  173.       phone# (415) 949-1788 - located in the Los Altos, Ca. area (USA)
  174.       (this is an Official Snappy_Inc. Software Release Site for the West
  175.       coast; We're the East coast release site - see below)
  176.  
  177.     - The Internet - OK, so this isn't *very* specific...but, if you have
  178.       access to the internet, ARCHIE for:
  179.             WNCODExx.ZIP
  180.       where "xx" is the version number, i.e. WNCODE26.ZIP for version 2.6 
  181.  
  182.      We will also try to upload current versions to: ftp.cica.indiana.edu
  183.  
  184.  
  185.       
  186. VIII. *** Other Snappy_Inc. Software ***
  187.  
  188. We generally develop utility programs for Windows 3.1. We currently have
  189. a handful of programs that we're working on (including a Windows Program
  190. Uninstaller) which we will release as FREEWARE. We welcome all ideas for
  191. future projects.
  192.  
  193.  
  194.  
  195. IX. *** Mailing List ***
  196.  
  197. We have been trying to maintain a mailing list of all users who have
  198. offered advice, bug reports or helped in BETA testing. Being on this
  199. list entitles you to FREE upgrades (personally e-mailed pre-releases) 
  200. and support. (in other words, you don't have to download Wincode from
  201. the Internet or an Online Service/BBS). For more information see the
  202. HELPME.TXT file.
  203.  
  204.  
  205.  
  206. X. *** Known Limitations ***
  207.  
  208. 1) Network Users: If Wincode is having problems opening and/or finding files
  209.    on a networked drive, edit the WINCODE.INI file and change/add the
  210.    following line:
  211.  
  212.    Network=1
  213.  
  214.    This will activate a bypass which allows Wincode to view the file
  215.    differently (i.e. not as a "DOS" file). If you still have problems, please
  216.    contact Snappy_Inc. with a detailed description.
  217.  
  218. 2) Certain video hardware/software combinations (such as ATI cards/drivers)
  219.    are known to cause irregular displays of various Wincode dialogs. Common
  220.    symptoms include misaligned text, irregularly spaced progress bars and
  221.    "absent menus". The Hooking feature is also not fully supported by all
  222.    applications. If you have problems hooking and application, try using the
  223.    "Tune.." options. If you experience any other difficulties, please let us
  224.    know. These known problems do NOT affect Wincode's coding functionality.
  225.  
  226.  
  227.  
  228. XI. *** Note to AOL Users ***
  229.  
  230. Here are answers to two common problems experienced by AOL Users:
  231.  
  232. 1) When downloading USENET posts from AOL, be certain that you receive the
  233.    ENTIRE message. You do this by pressing the 'More...' button until it
  234.    disappears or grays-out. AOL downloads files in 28K chunks and usually
  235.    does NOT receive the entire post when you select it. We have been told that
  236.    the 'Logging' option is the way to go for capturing LARGE files. For more
  237.    info, please contact the AOL support personnel.
  238. 2) If you want to Hook the AOL menu, use 'America  Online' as the Application
  239.    Name (do NOT include the quotes). The point is that there are TWO spaces
  240.    between 'America' and 'Online'.
  241.  
  242.  
  243.  
  244. XI. *** Copyrights ***
  245.  
  246. - portions of this program are copyright (C) 1991,1993 Borland
  247. - Windows is a trademark of Microsoft Corporation
  248. - PKZIP/UNZIP are copyright 1989-1993 PKWARE Inc. All Rights Reserved.
  249. - GIF is a service mark of CompuServe Incorporated
  250. - WordPerfect is a registered trademark of Novell, Inc.
  251. - Procomm Plus for Windows is copyright 1992-1993 Datastorm Technologies, Inc.
  252. - Star Trek: The Next Generation is a registered trademark of Paramount
  253.   Pictures
  254.  
  255.  
  256. Have fun!
  257.  
  258. George.---   Snappy_Inc. ;-)
  259.  
  260. Main Internet Address:   George.Silva@wadsworth.org  (preferred)
  261. CompuServe:              74640,1647 (74640.1647@compuserve.com)
  262. America Online:          Snappy (Snappy@aol.com)
  263. --------------------------------------------------------------------------
  264.  
  265. [GHS 10/31/94]
  266.